\section{SAL-T Manual}

This section is intended to provide information related to the setup and operation of the project result.

\subsection{Build / Installation}

Create a directory where all the components reside. It will be the \texttt{<BASEDIR>}.
Copy the SALT directory as well as the SAL directory into this BASEDIR\footnote{The reason for the need of SAL located in the same directory is related to the argument \texttt{java.rmi.server.codebase}, which should be resolved in a further development phase.}.


\begin{verbatim}
  cd <BASEDIR>
  svn checkout http://www.hpc.jcu.edu.au/projects/SAL/svn/SAL/trunk SAL
  svn checkout http://sal-t.googlecode.com/svn/trunk/ SALT
  cd SALT
  ant
\end{verbatim}

\subsection{Configuration} \label{config}

All parts of SALT are highly adaptable to any environment. This is valid for the SAL, the DataTurbine and the SRB connections which have to be established, as well as certain attributes defining the behavior. Therefore the configuration file \texttt{<BASEDIR>/SALT/salt.properties} has to be edited. The comments in the file explain the meaning of the key-value pairs.

\subsection{Dependencies / Preconditions} 

\begin{itemize}
\item SAL has to be up and running (default is the same machine as the SAL-GLUE is started - configurable within salt.properties (see \autoref{config}))
\item DataTurbine should be available (make use of the one we set up in our project room - configurable within salt.properties  (see \autoref{config}))
\item SRB should be accessible  (make use of the one provided by the client - configurable within salt.properties  (see \autoref{config}))
\end{itemize}

\subsection{Operation} 

To start the producer component:
\begin{verbatim}
  cd <BASEDIR>/SALT
  ./run-salt.sh sal
\end{verbatim}

To start the consumer component:

\begin{verbatim}
  cd <BASEDIR>/SALT
  ./run-salt.sh srb
\end{verbatim}

There are some more parameters available, which can be used for testing purposes. The parameters "send" and "recv" just send a simple text message through the turbine and receive it on the console. Just run 
\texttt{./run-salt.sh}  to see the options.
